package com.huangyi.adminservice.user.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.huangyi.adminapi.appuser.domain.dto.AppUserListReqDTO;
import com.huangyi.adminservice.user.domain.entity.AppUser;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 应用用户数据访问层接口
 * 
 * <p>提供应用用户相关的数据库操作，包括基础CRUD和自定义查询方法
 * 
 * @author huangyi
 * @version 1.0
 * @since 2024
 */
@Mapper
public interface AppUserMapper extends BaseMapper<AppUser> {

    /**
     * 根据openId查询用户信息
     * 
     * @param openId 用户微信ID
     * @return 应用用户信息
     */
    AppUser selectByOpenId(@Param("openId") String openId);

    /**
     * 根据手机号查询用户信息
     * 
     * @param phoneNumber 手机号
     * @return 应用用户信息
     */
    AppUser selectByPhoneNumber(@Param("phoneNumber") String phoneNumber);

    /**
     * 根据条件统计用户数量
     * 
     * @param appUserListReqDTO 查询条件
     * @return 用户总数
     */
    Long selectCount(AppUserListReqDTO appUserListReqDTO);

    /**
     * 根据条件分页查询用户列表
     * 
     * @param appUserListReqDTO 查询条件
     * @return 用户列表
     */
    List<AppUser> selectPage(AppUserListReqDTO appUserListReqDTO);
}
